package com.ruoyi.mapper;

import java.util.List;
import org.apache.ibatis.annotations.Param;
import com.ruoyi.domain.MobileUserCoupon;

/**
 * 手机端用户优惠券Mapper接口
 *
 * @author ruoyi
 * @date 2025-01-20
 */
public interface MobilUserCouponMapper {
    /**
     * 查询用户优惠券列表
     *
     * @param mobileUserCoupon 用户优惠券
     * @return 用户优惠券集合
     */
    public List<MobileUserCoupon> selectMobilUserCouponList(MobileUserCoupon mobileUserCoupon);

    /**
     * 根据用户ID查询优惠券列表（包含优惠券详细信息）
     *
     * @param userId 用户ID
     * @return 用户优惠券集合
     */
    public List<MobileUserCoupon> selectUserCouponsWithDetails(@Param("userId") Integer userId);

    /**
     * 根据用户ID查询可用优惠券列表
     *
     * @param userId 用户ID
     * @return 可用优惠券集合
     */
    public List<MobileUserCoupon> selectAvailableUserCoupons(@Param("userId") Integer userId);

    /**
     * 根据用户ID和商家ID查询可用优惠券列表（用于订单页面选择优惠券）
     *
     * @param userId 用户ID
     * @param merchantId 商家ID
     * @return 可用优惠券集合
     */
    public List<MobileUserCoupon> selectAvailableUserCouponsByMerchant(@Param("userId") Integer userId, @Param("merchantId") Integer merchantId);

    /**
     * 根据主键查询用户优惠券
     *
     * @param id 用户优惠券主键
     * @return 用户优惠券
     */
    public MobileUserCoupon selectMobilUserCouponById(Integer id);

    /**
     * 检查用户是否已领取指定优惠券
     *
     * @param userId 用户ID
     * @param couponId 优惠券ID
     * @return 用户优惠券记录
     */
    public MobileUserCoupon selectUserCouponByCouponId(@Param("userId") Integer userId, @Param("couponId") Integer couponId);

    /**
     * 新增用户优惠券
     *
     * @param mobileUserCoupon 用户优惠券
     * @return 结果
     */
    public int insertMobilUserCoupon(MobileUserCoupon mobileUserCoupon);

    /**
     * 修改用户优惠券
     *
     * @param mobileUserCoupon 用户优惠券
     * @return 结果
     */
    public int updateMobilUserCoupon(MobileUserCoupon mobileUserCoupon);

    /**
     * 使用优惠券（更新状态为已使用）
     *
     * @param id 用户优惠券ID
     * @return 结果
     */
    public int useCoupon(Integer id);

    /**
     * 删除用户优惠券
     *
     * @param id 用户优惠券主键
     * @return 结果
     */
    public int deleteMobilUserCouponById(Integer id);

    /**
     * 领取优惠券
     *
     * @param userId 用户ID
     * @param couponId 优惠券ID
     * @return 结果
     */
    public int receiveCoupon(@Param("userId") Integer userId, @Param("couponId") Integer couponId);
}